home *** CD-ROM | disk | FTP | other *** search
/ 3D Images / 3D Images.iso / programs / amiga / rayshade / man / getami.man < prev    next >
Text File  |  1995-01-12  |  4KB  |  96 lines
  1. NAME
  2.     getami - display an RLE image on a Commodore Amiga and optionally
  3.          save it as an IFF ILBM file.
  4.  
  5. SYNOPSIS
  6.     getami [-w width] [-h height] [-o IFFfile] [-fdlb3H] [input_file]
  7.  
  8. DESCRIPTION
  9.     Getami displays an RLE image on a Commodore Amiga. The program tries
  10.     to display the image in the best possible way, using HAM mode and
  11.     overscan when appropriate. Both NTSC and PAL Amigas are catered for.
  12.     In addition, the program allows you to save the displayed picture in
  13.     IFF format, using Christian Weber's iff.library.
  14.  
  15.     Getami understands the following options:
  16.  
  17.     -w width  Override the screen width computed by getami. Eg., use
  18.           -w 640 if getami selects a screen resolution of 320x400
  19.           (because the picture will fit in it), but what you really
  20.           want is 640x400.
  21.  
  22.     -h height Override the screen height computed by getami.
  23.  
  24.           Apart from the example mentioned above, these two options
  25.           are probably obsolete.
  26.  
  27.     -o file      Make getami act as an RLE->IFF converter: after rendering the
  28.           RLE file, getami saves the image in IFF form in the file
  29.           specified, then exits.
  30.  
  31.     -f      Render the image flipped vertically. This option is necessary,
  32.           because rleflip -v often requires more memory than available
  33.           on the amiga.
  34.  
  35.     -d      This option causes getami to dump the color map it computes
  36.           into file "cmap".
  37.  
  38.     -l      This option causes getami to ignore the color map it
  39.           computes, and to replace it with the color map stored in file
  40.           "cmap".
  41.  
  42.           These two options must be used if you are using getami to
  43.           create IFF files to be used as frames for an ANIM file, as
  44.           all frames have to have the same color map.
  45.  
  46.     -b      Render the image in black and white. This allows you to
  47.           display pictures at full resolution. (To display in color a
  48.           640x400 picture with more than 16 colors, you need to scale
  49.           it down to 320x400, not to mention the unavoidable blurriness
  50.           introduced by Hold And Modify.)
  51.  
  52.     -3      Render the image in 4096 colors without using HAM. This is
  53.           achieved by rendering the image in three screens, one for each
  54.           of its r,g,b components, then flipping through them in rapid
  55.           succession. Because of this rapid flipping, the image 
  56.           flickers. This is especially noticeable in conjunction with
  57.           interlace. If you are sensitive to screen flicker, please do
  58.           not use this option.
  59.  
  60.     -H      Force rendering of the image in HAM mode. Useful in rendering
  61.           animation frames, if getami happens to render some of the
  62.           frames in HAM mode and some in another mode.
  63.  
  64. MENU OPERATIONS
  65.     You can select the following actions from the menu bar:
  66.  
  67.     SAVE    Save the rendered picture in an IFF ILBM file. The picture will
  68.         be saved in a file with the extension ".ILBM". Eg., if you are
  69.         rendering a.rle, the picture will be saved in a.ILBM. If the
  70.         picture you are rendering comes from the standard input, you
  71.         will be asked to specify the name of the IFF file. This action
  72.         can also be invoked by pressing right Amiga-S.
  73.  
  74.     SAVE AS    Same as SAVE, but you are always asked for the name of the
  75.         IFF file. To cancel the save, simply give a null file name.
  76.         This action can also be invoked by pressing right Amiga-A.
  77.  
  78.         These two operations can only be invoked if you have Christian
  79.         Weber's iff.library in your LIBS: directory. If you save a
  80.         picture which has been rendered with the -3 option, you will
  81.         actually create three files, with extensions ".r", ".g", and
  82.         ".b", respectively. You can view this image using the show3
  83.         program.
  84.  
  85.     QUIT    Exit the program. This action can also be invoked by pressing
  86.         right Amiga-Q, or by clicking on the invisible gadget at the
  87.         top left corner.
  88.  
  89. AUTHORS
  90.     Eleftherios Koutsofios (ek@ulysses.att.com) wrote the first version of
  91.     this program, including the HAM rendering algorithm.
  92.  
  93.     Kriton Kyrimis (kyrimis@theseas.ntua.gr) added support for intuition,
  94.     overscan, saving files, the B&W and 4096 color display modes, and made
  95.     all sorts of improvements.
  96.